home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / ksptel50.zip / KSP-TLNT.DOC < prev    next >
Text File  |  1996-02-24  |  63KB  |  1,859 lines
  1.  
  2.  
  3.         
  4.  
  5.  
  6.                                  KSP Telnet (tm)
  7.  
  8.                     A Telnet Door for Bulletin Board Systems
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    Version 5.0
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                               Copyright (C) 1995-96
  31.                                All Rights Reserved
  32.  
  33.  
  34.                                        by
  35.  
  36.  
  37.                               KEY SOFTWARE PRODUCTS
  38.  
  39.                                 440 Ninth Avenue
  40.                         Menlo Park, California 94025-1802
  41.                               BBS/FAX: 415-364-9847
  42.  
  43.  
  44.  
  45.                KSP Telnet is a trademark of Key Software Products.
  46.                  PCL4C is a trademark of MarshallSoft Computing.
  47.                      WATTCP is a trademark of Erick Engelke.
  48.                      Power C is a trademark of Mix Software.
  49.                    Lantastic is a trademark of Artisoft, Inc.
  50.                       Novell is a trademark of Novell Corp.
  51.                    Banyan Vines is a trademark of Banyan Inc.
  52.              DESQview is a trademark of Quarterdeck Office Systems.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         
  59.  
  60.  
  61.                                 TABLE OF CONTENTS
  62.  
  63.  
  64.  
  65.         CHAPTER 1 - INTRODUCTION        ...........................    1
  66.            1.1  Other KSP Software      ...........................    1
  67.               1.1.1  KSP FTP       ................................    1
  68.               1.1.2  KSP SLIP       ...............................    1
  69.               1.1.3  KSP Mail       ...............................    1
  70.               1.1.4  KSP HOST       ...............................    2
  71.               1.1.5  So Many CD's      ............................    2
  72.            1.2  Compatibility with BBS Software     ...............    2
  73.            1.3  Hardware Requirements       .......................    2
  74.            1.4  Software Requirements       .......................    3
  75.  
  76.         CHAPTER 2 - INSTALLATION        ...........................    4
  77.            2.1  Packet Driver Shims for Novell    .................    4
  78.            2.2  Packet Driver Shim for Novell w/Token-RingSNAP   ..    5
  79.            2.3  Packet Driver Shims for Lantastic    ..............    5
  80.               2.3.1  Changes to CONFIG.SYS      ...................    5
  81.               2.3.2  Changes to PROTOCOL.INI      .................    6
  82.            2.4  Packet Driver Shims for Banyan Vines   ............    7
  83.            2.5  Other Things to Configure     .....................    7
  84.  
  85.         CHAPTER 3 - THE WATTCP CONFIGURATION FILE     .............    9
  86.            3.1  Multiple Nodes and the "include" Directive   ......   10
  87.            3.2  Using a BOOTP Server     ..........................   10
  88.            3.3  Manual Configuration       ........................   10
  89.               3.3.1  The PC's Host Name     .......................   11
  90.               3.3.2  The PC's Domain Name     .....................   11
  91.               3.3.3  The PC's IP Address     ......................   11
  92.               3.3.4  The Name Server's IP Address    ..............   12
  93.               3.3.5  The Router's IP Address     ..................   12
  94.               3.3.6  The PC's Network Mask     ....................   12
  95.            3.4  TCP/IP Parameters (optional)      .................   12
  96.               3.4.1  DNS Search Mode      .........................   13
  97.               3.4.2  Timeouts        ..............................   14
  98.               3.4.3  Maximum Segment Size (MSS)     ...............   14
  99.            3.5  Telnet Operating Parameters      ..................   14
  100.               3.5.1  Dynamic Parameters       .....................   15
  101.               3.5.2  Retrieving Hostname of Remote Server    ......   15
  102.               3.5.3  Blocking Access to Certain Sites    ..........   16
  103.               3.5.4  Allowing Access to a Limited Set of Sites ....   16
  104.               3.5.5  User Session Logging      ....................   16
  105.               3.5.6  Non-Standard Port/Fossil Break Detect     ....   16
  106.               3.5.7  Session Time Limit      ......................   17
  107.               3.5.8  Session Reserve Time      ....................   17
  108.               3.5.9  Inactivity Limit       .......................   17
  109.               3.5.10  Minimum Baud Rate      ......................   18
  110.               3.5.11  Operating Hours       .......................   18
  111.               3.5.12  Default Terminal Type      ..................   18
  112.               3.5.13  Disabling the Escape Sequence     ...........   19
  113.  
  114.  
  115.  
  116.         
  117.  
  118.  
  119.                                 TABLE OF CONTENTS
  120.  
  121.  
  122.               3.5.14  Disabling the ANSI Interface     ............   19
  123.               3.5.15  Disabling the RIP Interface     .............   19
  124.               3.5.16  Allowing 7-bit Callers      .................   20
  125.               3.5.17  Silencing the BBS console bell    ...........   20
  126.               3.5.18  Disabling the Local Screen     ..............   20
  127.  
  128.         CHAPTER 4 - INSTALLING THE TELNET DOOR COMMAND    .........   21
  129.            4.1  Command Line Parameters      ......................   21
  130.               4.1.1  The /MAXMINS Parameter      ..................   22
  131.               4.1.2  The /CONFIG Parameter      ...................   22
  132.  
  133.         CHAPTER 5 - INSTALLING YOUR ACCESS KEY     ................   23
  134.  
  135.         CHAPTER 6 - USING KSP TELNET      .........................   24
  136.            6.1  Command Mode Basics (CLI Only)    .................   24
  137.            6.2  Connected Mode Basics (CLI Only)    ...............   24
  138.            6.3  KSP Telnet Commands (RIP ANSI and GUI)  ...........   25
  139.  
  140.         APPENDIX 1 - HOW TO REACH US     ..........................   27
  141.  
  142.         APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    ..........   28
  143.  
  144.         APPENDIX 3 - LEGAL STUFF       ............................   29
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.         
  175.  
  176.  
  177.  
  178.         Feb 24, 1996          KSP Telnet (tm) v5.0                      1
  179.  
  180.  
  181.                         CHAPTER 1 - INTRODUCTION        
  182.  
  183.  
  184.         KSP  Telnet  is  a  BBS  door that implements the familiar Telnet
  185.         client  program  that  allows  users to login to remote computers
  186.         over a TCP/IP network.  
  187.  
  188.         If  your  BBS  is connected to the Internet, KSP Telnet lets your
  189.         BBS  callers  login  to remote machines anywhere in the world for
  190.         the cost of a phone call to your BBS! 
  191.  
  192.         KSP  Telnet  is  shareware.   The  unlicensed  version  is  fully
  193.         functional  except  that it imposes a maximum of five minutes per
  194.         Telnet  session.   Once licensed, the user is limited only by the
  195.         amount of time remaining in his BBS session.  
  196.  
  197.         KSP  Telnet  was  implemented  using Erick Engelke's Waterloo TCP
  198.         library,  MarshallSoft  Computing's PCL4C Personal Communications
  199.         library, and Mix Software's Power C compiler.  
  200.  
  201.         A  companion  program  called  KSP ftp allows your BBS callers to
  202.         upload  or  download  files from any computer on the Internet via
  203.         your   BBS.    When   KSP  ftp  is  installed,  it  automatically
  204.         integrates  into  KSP  Telnet.  Callers using KSP Telnet to login
  205.         to  a  remote  host  will  be able to use KSP ftp without leaving
  206.         their Telnet session to transfer files to and from that host.  
  207.  
  208.         1.1 Other KSP Software       
  209.  
  210.         Key  Software  Products  offers  a  number  of other products for
  211.         BBS's: 
  212.  
  213.  
  214.         1.1.1 KSP FTP        
  215.  
  216.         A  door  program  that  allows  callers to transfer files to/from
  217.         remote computers anywhere on the Internet via your BBS.  
  218.  
  219.  
  220.         1.1.2 KSP SLIP        
  221.  
  222.         A  door  program  that  allows callers to run any TCP/IP software
  223.         from  home,  including using Mosaic to browse the World Wide Web.
  224.         Available now on our BBS.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  234.  
  235.  
  236.         Feb 24, 1996          KSP Telnet (tm) v5.0                      2
  237.  
  238.  
  239.         1.1.3 KSP Mail        
  240.  
  241.         A  Multi-Threaded  Server  for  SMTP  Mail  and NNTP Usenet news.
  242.         Replaces  UUCP,  its  monthly  fees,  and slow transfer rates! No
  243.         more  unwanted  newsgroups!  Instant  mail  without  waiting  for
  244.         scheduled  events!   Works  with  any BBS software that presently
  245.         uses  UUCP.   Requires a 24hr TCP/IP Internet connection. Can now
  246.         receive NNTP news feeds! 
  247.  
  248.  
  249.         1.1.4 KSP HOST        
  250.  
  251.         An  inbound  Telnet  server  for  MS/DOS  Bulletin Board Systems.
  252.         Every  node  can  answer both telnet and modem calls!  Requires a
  253.         fossil  driver  on  each node, a 24 hour TCP/IP connection to the
  254.         Internet,  and a local area network that supports NetBios such as
  255.         Novell or Lantastic.  
  256.  
  257.  
  258.         1.1.5 So Many CD's       
  259.  
  260.         A  PCBoard PPE to handle off-line CD-Roms.  Seamlessly integrated
  261.         into  PCBoard.   Users  post requests for off-line files and have
  262.         then  returned  as  attachments to messages. Configurable message
  263.         pack-out  dates  automatically  keep  your hard disk from getting
  264.         cluttered.  Available now on our BBS.  
  265.  
  266.  
  267.         1.2 Compatibility with BBS Software      
  268.  
  269.         KSP  Telnet is compatible with any BBS software that can generate
  270.         a  DOOR.SYS  file.   It  works  with  a BBS configured to use the
  271.         standard  COM1  through  COM4 ports, or will automatically detect
  272.         and use a Fossil driver.  
  273.  
  274.  
  275.         1.3 Hardware Requirements        
  276.  
  277.         KSP  Telnet  inherently  requires  that  the  PC running your BBS
  278.         software  have  a  physical  connection  to  a  TCP/IP  network -
  279.         normally  the  Internet.  Ideally, this connection is by means of
  280.         an  adapter  card  connected  to  an  Ethernet at your company or
  281.         school (and then through a "gateway" to the Internet).  
  282.  
  283.         It  is  also  possible  to  connect to the Internet via a dial-up
  284.         SLIP  (Serial  Line Internet Protocol) connection to a commercial
  285.         Internet  Access  Provider.   This  approach  requires  a  second
  286.         serial   port,  modem,  and  telephone  line  dedicated  to  this
  287.         purpose.   Information on finding such a provider is available on
  288.  
  289.  
  290.  
  291.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  292.  
  293.  
  294.         Feb 24, 1996          KSP Telnet (tm) v5.0                      3
  295.  
  296.  
  297.         the KSP BBS.  
  298.  
  299.  
  300.         1.4 Software Requirements        
  301.  
  302.         KSP  Telnet  runs  on  top  of another piece of software called a
  303.         "packet  driver".  The packet driver presents a standard software
  304.         interface  to  KSP  Telnet,  regardless  of  the type of hardware
  305.         interface  that  connects  the  PC to the network.  Public domain
  306.         packet drivers exist for SLIP links and most Ethernet cards.  
  307.  
  308.         If  your  BBS  uses  a  multi-tasking  operating  system  to  run
  309.         multiple  nodes  on  a  single  PC,  then you will need a "packet
  310.         multiplexer".   A  packet  multiplexer  designed specifically for
  311.         use   with   KSP  network  products  running  under  DESQview  is
  312.         available  as  a  freeware  package  distributed  as KSPMUX*.ZIP,
  313.         where  the  "*"  is  the  version number.  KSP Telnet is DESQview
  314.         "aware"   to   provide   better  performance  in  a  multitasking
  315.         environment.  
  316.  
  317.         If  your  PC  is  connected  to  a non-TCP/IP proprietary network
  318.         (such  as  Novell  or Lantastic), you will probably need a packet
  319.         driver "shim".  
  320.  
  321.         KSP  Telnet  does NOT require that you purchase a separate TCP/IP
  322.         package,  such  as  that  sold  by Novell, Artisoft, or IBM.  KSP
  323.         Telent  should  happily  coexist  with  any  of  these  packages,
  324.         however.  
  325.  
  326.         An  assortment of public domain packet drivers, multiplexers, and
  327.         shims are available on the KSP BBS.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  350.  
  351.  
  352.         Feb 24, 1996          KSP Telnet (tm) v5.0                      4
  353.  
  354.  
  355.                         CHAPTER 2 - INSTALLATION        
  356.  
  357.  
  358.         Before  installing  KSP  Telnet  as  a  BBS  door, you must first
  359.         install: 
  360.  
  361.              1.  The network interface hardware.  
  362.              2.  A corresponding packet driver.  
  363.              3.  A packet driver shim (if needed).  
  364.              4.  A packet multiplexer (if needed).  
  365.  
  366.         Detailed  directions for these preliminary steps are available in
  367.         separate   documentation   that   comes  with  the  corresponding
  368.         hardware or software.   
  369.  
  370.         It's  most  common  that multi-node BBS's are interconnected with
  371.         Ethernet  and  either  Lantastic or Novell.  Unfortunately, these
  372.         two  network  operating  systems  were  designed  using their own
  373.         proprietary  protocols  rather than the TCP/IP protocol and their
  374.         own  proprietary  software  rather than packet drivers to talk to
  375.         their  Ethernet  interface  cards.   However, a piece of software
  376.         called  a packet driver "shim" can be used to let both TCP/IP and
  377.         their proprietary protocol coexist.  
  378.  
  379.  
  380.         2.1 Packet Driver Shims for Novell     
  381.  
  382.         Novell's  network  software is installed in layers as TSRs in the
  383.         order  shown  below.   These commands are usually found either in
  384.         the  AUTOEXEC.BAT  file  or  in another batch file in a directory
  385.         typically called C:\NWCLIENT.  
  386.  
  387.              LSL
  388.              NE2000  }-- specific to your interface card
  389.              IPXODI
  390.              VLM
  391.  
  392.         The  packet driver shim (ODIPKT) logically sits on top of IPXODI,
  393.         providing  a  packet  driver  interface  for software such as KSP
  394.         Telnet: 
  395.  
  396.              LSL
  397.              NE2000 +--- Frame Type (0-3)
  398.              IPXODI |
  399.              ODIPKT 2 97  }--- The packet driver shim
  400.              VLM       |
  401.                        +----- Packet Vector Interrupt (96-127)
  402.                               (See comment below about hex vs. decimal)
  403.  
  404.  
  405.  
  406.  
  407.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  408.  
  409.  
  410.         Feb 24, 1996          KSP Telnet (tm) v5.0                      5
  411.  
  412.  
  413.         The  ODIPKT  command  line parameters may vary according to which
  414.         version  of  the  software  you  have  and  how  your hardware is
  415.         configured.   The "Frame Type" parameter should correspond to the
  416.         position  of  ETHERNET_II  among  the  frame  types  specified in
  417.         NET.CFG;  zero  (0)  selects  the  first  frame type, one (1) the
  418.         second,  and  so on.  The "Packet Vector Interrupt" number should
  419.         correspond  to  an  unused  interrupt  vector.   Note  that older
  420.         versions  of  ODIPKT  insist that this number be given in decimal
  421.         (96-127)  rather  than  in hex (0x60-0x7F).  The necessary packet
  422.         driver  shim can be downloaded from the Key Software Products BBS
  423.         as file ODI-SHIM.ZIP.   
  424.  
  425.  
  426.         2.2 Packet Driver Shim for Novell w/Token-RingSNAP    
  427.  
  428.         Another  shim  called  ODITRPKT  exists for Novell that should be
  429.         used  if the underlying network is Token-Ring_SNAP.  Installation
  430.         is  similar  to  ODIPKT as described above, except that the first
  431.         command  line  parameter  must  correspond to the Token-Ring_SNAP
  432.         frame  type  in NET.CFG, and starts at "1" rather than "0".  This
  433.         shim  can  be  downloaded  from  the Key Software Products BBS as
  434.         file TKN-SHIM.ZIP.  
  435.  
  436.  
  437.         2.3 Packet Driver Shims for Lantastic     
  438.  
  439.         Using   a   packet  driver  shim  with  Lantastic  requires  that
  440.         Lantastic  be  installed  using  NDIS  (Network  Driver Interface
  441.         Specification)  Support.  The necessary packet driver shim can be
  442.         downloaded   from   the   Key   Software  Products  BBS  as  file
  443.         DIS-SHIM.ZIP.  
  444.  
  445.         NDIS   allows  you  to  stack  multiple  protocols  on  a  single
  446.         adapter.   This  lets  you use multiple protocol drivers (such as
  447.         LANtastic  and  TCP/IP)  on  the  same adapter.  You can also use
  448.         NDIS  to  include  third-party adapters that have NDIS drivers in
  449.         your   LANtastic   network.    Supported  adapter  types  include
  450.         Ethernet,  Token-Ring  and ARCNET (R) adapters.  The software and
  451.         documentation  necessary  to  add  NDIS  support  to  an existing
  452.         Lantastic network is available free of charge from Artisoft.  
  453.  
  454.         Once  you  have NDIS installed and working with Lantastic, adding
  455.         the  shim is a simple matter of editing PROTOCOL.INI (part of the
  456.         NDIS support) and CONFIG.SYS.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  466.  
  467.  
  468.         Feb 24, 1996          KSP Telnet (tm) v5.0                      6
  469.  
  470.  
  471.         2.3.1 Changes to CONFIG.SYS       
  472.  
  473.         With  NDIS  installed,  there  will be two device driver lines in
  474.         your CONFIG.SYS file that look something like the following: 
  475.  
  476.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  477.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  478.  
  479.         The  file  listed  in  the  second line may differ if you are not
  480.         using  Artisoft's  interface  card; in that case, this file would
  481.         typically  be  replaced  by  a  NDIS  driver supplied by the card
  482.         manufacturer.  
  483.  
  484.         The  packet  driver  shim  itself  is installed as a third device
  485.         driver after the first two, as in: 
  486.  
  487.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  488.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  489.              DEVICE=C:\DRIVERS\DIS_PKT.DOS  }--- The packet driver shim
  490.  
  491.  
  492.         2.3.2 Changes to PROTOCOL.INI       
  493.  
  494.         The  PROTOCOL.INI  file  is  a  text file created (usually in the
  495.         C:\LANTASTI  directory) as part of the NDIS installation.  Before
  496.         adding  the  packet  driver  shim,  it  typically  looks like the
  497.         following,  but  with  the  "iobase"  and  "interrupt" parameters
  498.         changed   according   to   your  hardware,  or  with  the  entire
  499.         "[AEXNDIS_NIF]"   section  replaced  if  you  are  not  using  an
  500.         Artisoft interface card.  
  501.  
  502.              [PROTMAN]
  503.                DRIVERNAME = PROTMAN$
  504.                DYNAMIC = YES
  505.  
  506.              [AEXNDIS_NIF]
  507.                DRIVERNAME = AEXNDS$
  508.                IOBASE = 0x300
  509.                INTERRUPT = 15
  510.  
  511.         Adding  the packet driver shim requires adding another section to
  512.         the PROTOCOL.INI file: 
  513.  
  514.              [PROTMAN]
  515.                DRIVERNAME = PROTMAN$
  516.                DYNAMIC = YES
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  524.  
  525.  
  526.         Feb 24, 1996          KSP Telnet (tm) v5.0                      7
  527.  
  528.  
  529.              [AEXNDIS_NIF]               <---+
  530.                DRIVERNAME = AEXNDS$          |
  531.                IOBASE = 0x300                |
  532.                INTERRUPT = 15                | These names must match!
  533.                                              |
  534.              [PKTDRV]                        |
  535.                DRIVERNAME = PKTDRV$          |
  536.                BINDINGS = AEXNDIS_NIF    <---+
  537.                INTVEC = 0x61
  538.                CHAINVEC = 0x66
  539.                NOVELL = Y
  540.  
  541.         Note  that the name "AEXNDIS_NIF" must exactly match the spelling
  542.         used  as  the  title of the previous section, "[AEXNDIS_NIF]"; if
  543.         you  are not using Artisoft interface cards, then both occurences
  544.         will  use  some  other identifier.  The "INTVEC" parameter may be
  545.         anything  from  0x60  to 0x80; you may have to experiment to find
  546.         an unused interrupt number.  
  547.  
  548.  
  549.         2.4 Packet Driver Shims for Banyan Vines    
  550.  
  551.         Although  Key  Software  Products  has  never  used  it, and thus
  552.         cannot  offer help on its installation, a packet driver shim does
  553.         exist  for  Banyan  Vines  and  can  be  downloaded  from the Key
  554.         Software Products BBS as file BAN-SHIM.ZIP.  
  555.  
  556.  
  557.         2.5 Other Things to Configure      
  558.  
  559.         Once  your  network  is  up and running with a packet driver or a
  560.         packet driver shim, there are basically two additional steps: 
  561.  
  562.              1.  Create a WATTCP.CFG configuration file.  
  563.              2.  Configure KSP Telnet as a BBS door.  
  564.  
  565.         As  discussed  in the next chapter, you may not need a WATTCP.CFG
  566.         configuration file if you have a BOOTP server.  
  567.  
  568.         There  is  a  useful  program called TCPINFO available on the KSP
  569.         BBS.   If  you have no WATTCP.CFG file, it will tell you (after a
  570.         maximum  of 30 seconds) if it was able to automatically configure
  571.         itself  via  a  BOOTP  server.  If you have a WATTCP.CFG file, it
  572.         will  determine  whether  or  not  you  have configured that file
  573.         properly.  
  574.  
  575.         Once  you  have a working WATTCP.CFG file, or have confirmed that
  576.         you  can  successfully  use a BOOTP server, you can then test KSP
  577.         Telnet  by  running it on your local console before installing it
  578.  
  579.  
  580.  
  581.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  582.  
  583.  
  584.         Feb 24, 1996          KSP Telnet (tm) v5.0                      8
  585.  
  586.  
  587.         as a door.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  640.  
  641.  
  642.         Feb 24, 1996          KSP Telnet (tm) v5.0                      9
  643.  
  644.  
  645.                  CHAPTER 3 - THE WATTCP CONFIGURATION FILE     
  646.  
  647.  
  648.         In  order to run, KSP Telnet needs to know some information about
  649.         your  network,  and  tries  to  find this in a configuration file
  650.         called  WATTCP.CFG.   KSP  Telnet  looks  in three directories to
  651.         locate  this  file.  First, it checks for an environment variable
  652.         called  WATTCP.CFG  that  specifies  the  directory.   Second, it
  653.         looks  in  the  current (default) directory.  Third, if still not
  654.         found,  it  looks  in  the directory that contains the executable
  655.         (KSP-TLNT.EXE).   
  656.  
  657.         The  following  example  may  be  helpful  for  those  using  the
  658.         environment  variable  approach:  If you place WATTCP.CFG in your
  659.         PCB  directory,  then  your  AUTOEXEC.BAT file should contain the
  660.         following command: 
  661.  
  662.                               set WATTCP.CFG=C:\PCB
  663.  
  664.           Note that there is no trailing "\" after the directory name!
  665.  
  666.         If  KSP  Telnet  still can't find the configuration file, it will
  667.         attempt  to  automatically  configure  itself  by  looking  for a
  668.         "BOOTP"  server  on  your network.  (BOOTP is a standard protocol
  669.         that  obtains  your "IP address" and other information about your
  670.         PC  from  a  BOOTP  server.)   If there is no BOOTP server, or if
  671.         your  PC  is not registered in its database, then you must create
  672.         a configuration file.  
  673.  
  674.         The  configuration  file  contains  one entry per line.  A sample
  675.         configuration  file  is  included  in  this distribution, but the
  676.         values  MUST  be  modified to suit your particular environment or
  677.         else KSP Telnet will not work!   
  678.  
  679.         The syntax of every entry follows the following format: 
  680.  
  681.            [ directive = [ "data" | data] ] [ # comment | ; comment ]
  682.  
  683.         I.e.,  if  a  directive is not followed by data, the directive is
  684.         ignored.   Similary,  lines  without directives are ignored.  The
  685.         directive is NOT case sensitive; the data IS case sensitive.   
  686.  
  687.         e.g.,   netmask=255.255.252.0
  688.                 domainslist=ksp.com    ; Our domain
  689.  
  690.         Whitespace  is normally removed from data; data containing blanks
  691.         must  be  surrounded by quotes.  An unquoted '#' or ';' marks the
  692.         beginning of a comment.  
  693.  
  694.  
  695.  
  696.  
  697.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  698.  
  699.  
  700.         Feb 24, 1996          KSP Telnet (tm) v5.0                     10
  701.  
  702.  
  703.  
  704.         3.1 Multiple Nodes and the "include" Directive    
  705.  
  706.         There  must  be  one WATTCP.CFG file for each BBS node since each
  707.         node  has  to  be  configured  with  a  unique  hostname  and  IP
  708.         address.   All  other configuration parameters are usually set at
  709.         the  same  values  for  all nodes.  Rather than duplicating these
  710.         common  entries  in each WATTCP.CFG file, you can set-up a master
  711.         configuration   file   that   gets  "included"  in  each  of  the
  712.         node-specific   files.    For  example,  the  node-specific  file
  713.         (WATTCP.CFG) might look like: 
  714.  
  715.                 include=c:\ksp\master.cfg
  716.                 hostname=ourbbspc
  717.                 myip=125.283.210.17
  718.  
  719.         This  makes it much easier to make changes since you only have to
  720.         modify a single file (MASTER.CFG).  
  721.  
  722.  
  723.         3.2 Using a BOOTP Server      
  724.  
  725.         It's  always  a good idea to have a configuration file whether or
  726.         not   you   use   a  BOOTP  server.   If  you  choose  to  use  a
  727.         configuration  file  and want to tell it to use the BOOTP server,
  728.         this  option  allows  you  to specify your the IP address of your
  729.         BOOTP server.  
  730.  
  731.  
  732.                 Example: bootp=129.255.0.128 
  733.  
  734.         You  should  specify the domain name manually as described in the
  735.         next  section  since  the  BOOTP  protocol  doesn't  provide that
  736.         information.  
  737.  
  738.                 Example: domainslist=ksp.com 
  739.  
  740.         NOTE:  An  "IP  address"  is  a logical addressing scheme used on
  741.         TCP/IP  networks  such  as the Internet.  Each computer connected
  742.         to  the  Internet  is  assigned  a unique IP address.  Your local
  743.         network  "guru"  or access provider should be able to provide you
  744.         with those IP addresses you need.   
  745.  
  746.         IMPORTANT:  The  IP  addresses  given  in  this document are only
  747.         examples.   Do  NOT  attempt to use them - they will NOT work and
  748.         your network administrator will probably get VERY upset! 
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  756.  
  757.  
  758.         Feb 24, 1996          KSP Telnet (tm) v5.0                     11
  759.  
  760.  
  761.         3.3 Manual Configuration        
  762.  
  763.         If  you  don't  have  a  BOOTP  server,  or  if  your  PC  is not
  764.         registered  with  a BOOTP server, then you must use the following
  765.         directives   to  configure  KSP  Telnet.   The  values  of  these
  766.         parameters  are  important,  and  KSP  Telnet  will  NOT function
  767.         properly  without  the  proper  values.   If you are not familiar
  768.         with  the terminology, or if you are unsure of the proper values,
  769.         please consult with your network access provider.  
  770.  
  771.  
  772.         3.3.1 The PC's Host Name      
  773.  
  774.         This  is  the network name of the PC that runs your BBS (and thus
  775.         KSP  Telnet).   If  your BBS is implemented by a network of PC's,
  776.         then each PC should have its own unique host name.  
  777.  
  778.                 Example: hostname=bbs 
  779.  
  780.         Note  that  the  host  name  does  not  include  the  domain name
  781.         suffix.   For  example, the hostname of machine '"bbs.ksp.com" is
  782.         simply "bbs".  
  783.  
  784.  
  785.         3.3.2 The PC's Domain Name      
  786.  
  787.         This  is  the  network  name  of the subnet to which your PC (and
  788.         possibly others) are connected.  
  789.  
  790.                 Example: domainslist=ksp.com 
  791.  
  792.         Note  that  the  domain  name  does  not  include  the  host name
  793.         prefix.   For  example, the domain name of machine '"bbs.ksp.com"
  794.         is "ksp.com".  
  795.  
  796.  
  797.         3.3.3 The PC's IP Address      
  798.  
  799.         This is the unique IP address assigned to your PC.  
  800.  
  801.                 Example: my_ip=100.2.37.4  
  802.  
  803.         Your  local  network  "guru" or access provider should be able to
  804.         provide  you  with  the  proper IP address of your PC.  Note that
  805.         you  should  have  a  different  IP address for each node in your
  806.         BBS.  
  807.  
  808.         Note:  As  an  alternative, you may also set the IP address using
  809.         an environment variable, as in: 
  810.  
  811.  
  812.  
  813.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  814.  
  815.  
  816.         Feb 24, 1996          KSP Telnet (tm) v5.0                     12
  817.  
  818.  
  819.  
  820.                               set ksp-ip=100.2.37.4
  821.  
  822.  
  823.         3.3.4 The Name Server's IP Address     
  824.  
  825.         This  is  the  unique  IP  address  assigned  to  a  network name
  826.         nerver.   You  may  specify more than on nameserver by using more
  827.         than one "nameserver" line.  
  828.  
  829.                 Example: nameserver=111.21.108.110 
  830.  
  831.         Your  local  network  "guru" or access provider should be able to
  832.         provide  you  with the proper IP addresses of appropriate network
  833.         name servers.  
  834.  
  835.  
  836.         3.3.5 The Router's IP Address      
  837.  
  838.         This is the unique IP address assigned to the network router.  
  839.  
  840.           Syntax: gateway = ipaddr [ , subnet [ , subnet_mask ] ] 
  841.  
  842.                 Examples: gateway=129.97.176.1
  843.                           gateway=129.97.176.2, 129.97.0.0
  844.                           gateway=129.97.176.2, 129.97.0.0, 255.255.0.0
  845.  
  846.         Usually  the  (destination)  subnet  and  subnet mask need not be
  847.         specified,  and  is  used to create a "default".  The other forms
  848.         are  used  to  specify  one or more other gatewaya for particular
  849.         subnets.  
  850.  
  851.         Your  local  network  "guru" or access provider should be able to
  852.         provide you with the proper IP address of the network router.  
  853.  
  854.  
  855.         3.3.6 The PC's Network Mask      
  856.  
  857.         Network  masks  are  used to distinguish destination IP addresses
  858.         that  are  on  the  local  subnet  from those that are not.  This
  859.         option may not be required, depending on your network topology.  
  860.  
  861.                 Example: netmask=255.255.254.0 
  862.  
  863.         Your  local  network  "guru" or access provider should be able to
  864.         provide you with the proper netmask if needed.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  872.  
  873.  
  874.         Feb 24, 1996          KSP Telnet (tm) v5.0                     13
  875.  
  876.  
  877.         3.4 TCP/IP Parameters (optional)       
  878.  
  879.         KSP  Telnet will work without using the following parameters, but
  880.         they are provided if you wish to change them.  
  881.  
  882.  
  883.         3.4.1 DNS Search Mode       
  884.  
  885.         A  remote  hostname  (e.g.,  ralph.ksp.com) is translated into an
  886.         numeric  IP  addresse  (e.g.,  128.16.202.12)  by  a  nameserver.
  887.         Sometimes,  however,  users  enter  hostnames  in  an abbreviated
  888.         form.   For  example,  if  the local machine (e.g., ruby.ksp.com)
  889.         was   in   the   same   domain   (ksp.com)  as  the  remote  host
  890.         (ralph.ksp.com),  then  perhaps  only the remote hostname (ralph)
  891.         might  be given.  Short versions like this must be fully expanded
  892.         (e.g.,  ralph.ksp.com)  before  a  nameserver  can translate them
  893.         into an IP address.  
  894.  
  895.         Waterloo  TCP/IP  solves  this  by  feeding the nameserver with a
  896.         sequence  of  constructions  formed  from the remote hostname and
  897.         the  local machine's domainslist.  For a remote hostname given as
  898.         "a.b"  and  a  domainslist  specified  in  WATTCP.CFG  as  "c.d",
  899.         Waterloo  TCP/IP  would  attempt  name  server  lookups  first on
  900.         "a.b.c.d",  then  on  "a.b.d",  and then on "a.b".  Although this
  901.         approach  is  guaranteed to find the appropriate construction, it
  902.         can  waste  time  performing  nameserver  lookups  on  improbable
  903.         constructions.  
  904.  
  905.         Consider  the sequence of constructions attempted when the remote
  906.         hostname   is  "garbo.uwasa.fi"  and  the  local  domainslist  is
  907.         "ksp.com": 
  908.  
  909.                 (1) garbo.uwasa.fi.ksp.com      -> fails
  910.                 (2) garbo.uwasa.fi.com          -> fails
  911.                 (3) garbo.uwasa.fi              -> succeeds
  912.  
  913.         We've  modified  Waterloo  TCP/IP's search strategy to accelerate
  914.         name  server  lookups  by  adding three optional mode variations,
  915.         enabled   by   specifying   one   of   the  following  WATTCP.CFG
  916.         configuration parameters: 
  917.  
  918.         dns_search_mode=map_local_names 
  919.  
  920.             Abbreviated  (local)  hostnames  that do not contain a period
  921.             are   processed  in  the  normal  (Waterloo  TCP/IP)  manner.
  922.             Otherwise,  hostnames  like  "garbo.uwasa.fi"  are  attempted
  923.             immediately  without  modification.   This is the recommended
  924.             search mode.  
  925.  
  926.  
  927.  
  928.  
  929.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  930.  
  931.  
  932.         Feb 24, 1996          KSP Telnet (tm) v5.0                     14
  933.  
  934.  
  935.         dns_search_mode=fully_specified 
  936.  
  937.             This  mode  passes  the  hostname  directly to the nameserver
  938.             without  modification.   I.e.,  it assumes that hostnames are
  939.             always  fully  specified  by  the  user without abbreviation.
  940.             Abbreviated   names  will  not  be  translated  and  will  be
  941.             returned by the nameserver as unknown.  
  942.  
  943.         dns_search_mode=recognized_root 
  944.  
  945.             Remote  hostnames  ending in the common domain suffixes (com,
  946.             edu,   gov,   mil,   net,  org,  nato,  arpa)  are  attempted
  947.             immediately  without  modification.   All other hostnames are
  948.             processed  in  the normal manner.  (Note that this mode is no
  949.             better  than  the  normal Waterloo TCP/IP strategy with names
  950.             like "garbo.uwasa.fi".) 
  951.  
  952.  
  953.         3.4.2 Timeouts         
  954.  
  955.         Most  network  operations (such as establishing a connection to a
  956.         remote  host)  have a maximum time before a timeout error occurs.
  957.         The  default  value is 30 seconds; a smaller value is unwise, but
  958.         larger   values   may   be   necessary   for   particularly   bad
  959.         connections.  
  960.  
  961.                 Example: sockdelay=40 
  962.  
  963.  
  964.         3.4.3 Maximum Segment Size (MSS)      
  965.  
  966.         The  default  value  of  MSS  is  1400.  If you know what maximum
  967.         segment  size  means  and know what size you want, you can change
  968.         it: 
  969.  
  970.                 Example: mss=512 
  971.  
  972.                 Note:  Some  Internet  access  providers  configure their
  973.                 dial-up  slip  and ppp accounts with a very small segment
  974.                 size.   You  may  need  to  set mss as low as 212 if your
  975.                 Internet connection is through such a connection.  
  976.  
  977.  
  978.         3.5 Telnet Operating Parameters       
  979.  
  980.         The  remaining  parameters in WATTCP.CFG are operating parameters
  981.         for  KSP Telnet that define limits and display files needed while
  982.         KSP Telnet is running.  Each follows the format: 
  983.  
  984.  
  985.  
  986.  
  987.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  988.  
  989.  
  990.         Feb 24, 1996          KSP Telnet (tm) v5.0                     15
  991.  
  992.  
  993.                 ksp-tlnt.<parameter>=<value> 
  994.  
  995.         where   <parameter>  and  <value>  are  replaced  by  appropriate
  996.         strings.  
  997.  
  998.         Some  operating  parameters have counterparts in other members of
  999.         the  KSP  family  of  network  application programs.  Rather than
  1000.         have   multiple   entries   in   the  WATTCP.CFG  file  for  each
  1001.         application,  such parameters can be specified globally using the
  1002.         format: 
  1003.  
  1004.                 ksp.<parameter>=<value> 
  1005.  
  1006.         This  global setting can be overridden for a specific application
  1007.         by  using  the  application-specific form at a subsequent line in
  1008.         WATTCP.CFG.  
  1009.  
  1010.  
  1011.         3.5.1 Dynamic Parameters        
  1012.  
  1013.         Configuration  file  parameters  can  be  made  "dynamic".   Such
  1014.         parameters  are ignored unless activated by an associated command
  1015.         line option: 
  1016.  
  1017.                 /CONFIG=<number> 
  1018.  
  1019.         where  "<number>"  is  a non-zero integer.  Dynamic configuration
  1020.         parameters  are  those that specify a number in square backets as
  1021.         in: 
  1022.  
  1023.                 ksp-tlnt[<number>].<parameter>=<value> 
  1024.  
  1025.         The  number  specified  in the configuration parameter must match
  1026.         that  in  the  command  line  option  or  else  the configuration
  1027.         parameter will be ignored.  
  1028.  
  1029.         This also works for dynamic global parameters of the form: 
  1030.  
  1031.                 ksp[<number>].<parameter>=<value> 
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1046.  
  1047.  
  1048.         Feb 24, 1996          KSP Telnet (tm) v5.0                     16
  1049.  
  1050.  
  1051.         3.5.2 Retrieving Hostname of Remote Server     
  1052.  
  1053.          Syntax: ksp-tlnt.retrieve_hostnames=<option> 
  1054.  
  1055.         Example: ksp-tlnt.retrieve_hostnames=enabled 
  1056.  
  1057.         Purpose: If  enabled,  IP addresses of remote telnet servers will
  1058.                  be  translated  into  hostnames  using  the  domain name
  1059.                  server  to  provide  a reliable identification.  Affects
  1060.                  both the display and the log files.  
  1061.  
  1062.         Comment: Default is disabled.  
  1063.  
  1064.  
  1065.         3.5.3 Blocking Access to Certain Sites     
  1066.  
  1067.          Syntax: ksp-tlnt.blocked_ip_list=<pathspec> 
  1068.  
  1069.         Example: ksp-tlnt.blocked_ip_list=c:\ksp\blocked.lst 
  1070.  
  1071.         Purpose: Specifies  the  name of a text file containing a list of
  1072.                  blocked  IP  addresses.  No user access to sites on this
  1073.                  list will be allowed.  
  1074.  
  1075.  
  1076.         3.5.4 Allowing Access to a Limited Set of Sites  
  1077.  
  1078.          Syntax: ksp-tlnt.allowed_ip_list=<pathspec> 
  1079.  
  1080.         Example: ksp-tlnt.allowed_ip_list=c:\ksp\allowed.lst 
  1081.  
  1082.         Purpose: Specifies  the  name of a text file containing a list of
  1083.                  IP   addresses   to  which  the  users  are  allowed  to
  1084.                  connect.   No user access to sites not on this list will
  1085.                  be allowed.  
  1086.  
  1087.  
  1088.         3.5.5 User Session Logging       
  1089.  
  1090.          Syntax: ksp-tlnt.log_dir=<pathspec> 
  1091.  
  1092.         Example: ksp-tlnt.log_dir=c:\ksp-tlnt 
  1093.  
  1094.         Purpose: Specifies  the  name  of a directory where a log of user
  1095.                  sessions   will  be  kept.   The  log  files  are  named
  1096.                  KSP-TLNT.???, where "???" is the BBS node number.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1104.  
  1105.  
  1106.         Feb 24, 1996          KSP Telnet (tm) v5.0                     17
  1107.  
  1108.  
  1109.         3.5.6 Non-Standard Port/Fossil Break Detect      
  1110.  
  1111.          Syntax: ksp-tlnt.serial_port=<adr>,<irq> 
  1112.  
  1113.         Example: ksp-tlnt.serial_port=3F8,5 
  1114.  
  1115.         Purpose: Used  to  override serial port and IRQ values implied by
  1116.                  "COMx"    in    DOOR.SYS    to    support   non-standard
  1117.                  configurations  that  are  NOT  using  a  fossil driver.
  1118.                  Also  used  WITH  a  fossil  driver  to add serial break
  1119.                  detection  as  required  when  Telnet  connection  is in
  1120.                  binary mode.  
  1121.  
  1122.                  The  port  address  <adr>  must be specified in hex, and
  1123.                  the   interrupt   request  line  number  <irq>  must  be
  1124.                  specified in decimal.  
  1125.  
  1126.  
  1127.         3.5.7 Session Time Limit       
  1128.  
  1129.          Syntax: ksp-tlnt.max_mins=<number> 
  1130.  
  1131.         Example: ksp-tlnt.max_mins=30 
  1132.  
  1133.         Purpose: Overrides  the  time  remaining as specified in DOOR.SYS
  1134.                  if  lower.  If omitted, time remaining is that specified
  1135.                  by DOOR.SYS.  
  1136.  
  1137.  
  1138.         3.5.8 Session Reserve Time       
  1139.  
  1140.          Syntax: ksp-tlnt.reserve_mins=<number> 
  1141.  
  1142.         Example: ksp-tlnt.reserve_mins=3 
  1143.  
  1144.         Purpose: Reduces  the  time available in the door so that if time
  1145.                  runs  out,  the  user  still  has a small amount of time
  1146.                  left  on  the BBS.  This is useful, for example, if your
  1147.                  BBS  offers  a  Time  Bank  so  that users can use it to
  1148.                  withdraw extra time.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1162.  
  1163.  
  1164.         Feb 24, 1996          KSP Telnet (tm) v5.0                     18
  1165.  
  1166.  
  1167.         3.5.9 Inactivity Limit        
  1168.  
  1169.          Syntax: ksp-tlnt.idle_mins=<minutes> 
  1170.  
  1171.         Example: ksp-tlnt.idle_mins=10 
  1172.  
  1173.         Purpose: Establishes  an  upper limit on how long the session can
  1174.                  remain  inactive  before  it is terminated.  If omitted,
  1175.                  no inactivity limit is imposed.  
  1176.  
  1177.  
  1178.         3.5.10 Minimum Baud Rate       
  1179.  
  1180.          Syntax: ksp-tlnt.minbaud=<baudrate>[,<security>] 
  1181.  
  1182.         Example: ksp-tlnt.minbaud=9600 
  1183.  
  1184.         Example: ksp-tlnt.minbaud=9600,100 
  1185.  
  1186.         Purpose: Specifies  a  minimum  baud  rate  required  to  use the
  1187.                  gateway,  and  an  optional  security  level required to
  1188.                  override  the minimum baud rate.  If omitted, no minimum
  1189.                  baud rate will be required.  
  1190.  
  1191.  
  1192.         3.5.11 Operating Hours        
  1193.  
  1194.          Syntax: ksp-tlnt.ophours=<hh:mm-hh:mm> 
  1195.  
  1196.         Example: ksp-tlnt.ophours=21:00-23:00 
  1197.  
  1198.         Purpose: To  establish  the  hours  of operation for the gateway;
  1199.                  attempts  to  use  the  gateway  at  other times will be
  1200.                  disallowed.    Times   must  be  specified  in  24  hour
  1201.                  format.   If  omitted,  the  gateway  may be used at any
  1202.                  time.  
  1203.  
  1204.         Note: If  start  time  is  after  the  stop  time,  the  hours of
  1205.               operation  will  be  interpreted  as  all  but those in the
  1206.               window  specified.   I.e.,  setting  ophours to 03:20-03:00
  1207.               will allow operation anytime except 03:00-03:20.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1220.  
  1221.  
  1222.         Feb 24, 1996          KSP Telnet (tm) v5.0                     19
  1223.  
  1224.  
  1225.         3.5.12 Default Terminal Type       
  1226.  
  1227.          Syntax: ksp-tlnt.termtype=<termtypename> 
  1228.  
  1229.         Example: ksp-tlnt.termtype=vt100 
  1230.  
  1231.         Purpose: Changes  the  default  terminal  type  reported  to  the
  1232.                  remote  host when user is in either ANSI graphics or RIP
  1233.                  mode.  
  1234.  
  1235.  
  1236.         3.5.13 Disabling the Escape Sequence      
  1237.  
  1238.          Syntax: ksp-tlnt.escape=<option> 
  1239.  
  1240.         Example: ksp-tlnt.escape=disabled 
  1241.  
  1242.         Purpose: Used  to  disable  the  Telnet  escape  sequence and the
  1243.                  associated  message  at  connection that describes which
  1244.                  keystrokes  are  used  to  escape  back to command mode.
  1245.                  This  option  eliminates  the  "set escape" command from
  1246.                  the  standard command-line style interface, but not from
  1247.                  the interactive ANSI menu nor the RIP graphics menu.  
  1248.  
  1249.                  Note:  Disabling  this keystroke means that the only way
  1250.                  to  return  to  Telnet  command mode is to terminate the
  1251.                  remote session or to hang up.  
  1252.  
  1253.  
  1254.         3.5.14 Disabling the ANSI Interface      
  1255.  
  1256.          Syntax: ksp-tlnt.ansi_interface=<option> 
  1257.  
  1258.         Example: ksp-tlnt.ansi_interface=disabled 
  1259.  
  1260.         Purpose: Used  to  disable  the  blue  interactive user interface
  1261.                  presented  to novice mode users whose BBS connection has
  1262.                  ANSI  graphics  enabled  with  a  9600  baud  or  better
  1263.                  connection.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1278.  
  1279.  
  1280.         Feb 24, 1996          KSP Telnet (tm) v5.0                     20
  1281.  
  1282.  
  1283.         3.5.15 Disabling the RIP Interface      
  1284.  
  1285.          Syntax: ksp-tlnt.rip_interface=<option> 
  1286.  
  1287.         Example: ksp-tlnt.rip_interface=disabled 
  1288.  
  1289.         Purpose: Used   to  disabled  the  RIP  graphics  user  interface
  1290.                  presented  to  callers  whose  BBS  connection is in RIP
  1291.                  mode.  
  1292.  
  1293.  
  1294.         3.5.16 Allowing 7-bit Callers       
  1295.  
  1296.          Syntax: ksp-tlnt.7bit_warning=<message> 
  1297.  
  1298.         Example: ksp-tlnt.7bit_warning=Up/Downloads don't work w/7 bits! 
  1299.  
  1300.         Purpose: Normally,  KSP Telnet will disallow 7-bit callers.  This
  1301.                  option  can be used to allow such callers and to display
  1302.                  an  appropriate  warning message.  If no warning message
  1303.                  is  desired,  use  the  option  with a blank "<message>"
  1304.                  parameter.  
  1305.  
  1306.  
  1307.         3.5.17 Silencing the BBS console bell     
  1308.  
  1309.          Syntax: ksp-tlnt.local_bell=<option> 
  1310.  
  1311.         Example: ksp-tlnt.local_bell=disabled 
  1312.  
  1313.         Purpose: Used to silence the bell on the local BBS console.  
  1314.  
  1315.  
  1316.         3.5.18 Disabling the Local Screen      
  1317.  
  1318.          Syntax: ksp-tlnt.local_screen=<option> 
  1319.  
  1320.         Example: ksp-tlnt.local_screen=disabled 
  1321.  
  1322.         Purpose: Improves  caller's  display  speed  by  displaying  only
  1323.                  prompts   and   user   response  on  local  BBS  screen.
  1324.                  Eliminates local display of output from remote host.  
  1325.  
  1326.                  Note:  Pressing Shift-F1 on the local console of the BBS
  1327.                  while   a  caller  is  in  the  door  will  toggle  this
  1328.                  setting.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1336.  
  1337.  
  1338.         Feb 24, 1996          KSP Telnet (tm) v5.0                     21
  1339.  
  1340.  
  1341.                CHAPTER 4 - INSTALLING THE TELNET DOOR COMMAND    
  1342.  
  1343.  
  1344.         Install  KSP  Telnet  as you would any other door program on your
  1345.         BBS.   Be  sure  you  setup the BBS to create a DOOR.SYS file for
  1346.         KSP  Telnet  when  it runs.  (KSP Telnet does not need a USER.SYS
  1347.         file.)   If you are running multiple BBS nodes accessing a single
  1348.         copy  of  the  file  KSP-TLNT.EXE, then don't forget to make that
  1349.         file  read-only  using  the  DOS ATTRIB command in order to avoid
  1350.         sharing conflicts.  
  1351.  
  1352.         Most  BBS's  use  a  batch  file  to run a door.  For example, on
  1353.         PCBoard  systems you might create a door batch file called simply
  1354.         "TELNET" containing: 
  1355.  
  1356.                 C:\KSP\KSP-TLNT %PCBDOOR% 
  1357.                 BOARD 
  1358.  
  1359.         Do  NOT  change  directories  within this batch file!  KSP Telnet
  1360.         expects  to  find  the  DOOR.SYS  file in whatever is the default
  1361.         directory  at  the  moment it starts to run.  That's why the name
  1362.         of  the  program  is preceeded by the name of the directory where
  1363.         it is located.  
  1364.  
  1365.         Of  course, you must also configure your BBS so it knows where to
  1366.         find this batch file (TELNET).  
  1367.  
  1368.  
  1369.         4.1 Command Line Parameters       
  1370.  
  1371.         In   PCBoard,  "%PCBDOOR%"  is  replaced  by  the  value  of  the
  1372.         environment  variable  called  "PCBDOOR"  which  is  set  to  the
  1373.         command  line  parameters  (if any) entered with the door command
  1374.         before  exiting  to  run  the  door.   For  example,  the PCBoard
  1375.         command: 
  1376.  
  1377.                 TELNET scuacc.scu.edu 
  1378.  
  1379.         sets  the  environment  variable  "PCBDOOR"  to  "scuacc.scu.edu"
  1380.         before  exiting  to  run  the  door.  Effectively, the batch file
  1381.         "TELNET" becomes: 
  1382.  
  1383.                 KSP-TLNT scuacc.scu.edu 
  1384.                 BOARD 
  1385.  
  1386.         If  a  host  name  or  IP address is given (as above), KSP Telnet
  1387.         will  automatically  connect  to  that  host at startup, and will
  1388.         return  to  the  BBS  as  soon  as  the session with that host is
  1389.         finished (e.g., the user logs out).  
  1390.  
  1391.  
  1392.  
  1393.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1394.  
  1395.  
  1396.         Feb 24, 1996          KSP Telnet (tm) v5.0                     22
  1397.  
  1398.  
  1399.  
  1400.         If  no  host  name or IP address is given, KSP Telnet will prompt
  1401.         the  user  for  the  host id when the door starts to run.  Unlike
  1402.         the  situation  described  above,  when  the  user  logs out of a
  1403.         remote  host,  control  is returned to KSP Telnet command mode so
  1404.         that the user can then connect to a different host.  
  1405.  
  1406.         A  second  (third)  command  line  parameter  may  be provided to
  1407.         specify  the  login  name (password).  I.e., the complete command
  1408.         line syntax is: 
  1409.  
  1410.             KSP-TLNT [<name_or_IP> [<login_name> [login_password]]] 
  1411.  
  1412.         where the square brackets "[]" indicate optional parameters.  
  1413.  
  1414.         There  are  two  additional  command  line parameters that may be
  1415.         used: 
  1416.  
  1417.  
  1418.         4.1.1 The /MAXMINS Parameter       
  1419.  
  1420.         The  /MAXMINS  parameter is an alternative to a similar parameter
  1421.         that  appears  in  the  WATTCP.CFG  file.   It  provides  another
  1422.         mechanism  for  limiting  the maximum time a caller is allowed in
  1423.         the door.  The syntax is: 
  1424.  
  1425.                 /MAX_MINS=<minutes> 
  1426.  
  1427.         where "<minutes>" is replaced by a number, as in: 
  1428.  
  1429.                 KSP-TLNT scuacc.scu.edu /MAX_MINS=60 
  1430.  
  1431.  
  1432.         4.1.2 The /CONFIG Parameter       
  1433.  
  1434.         The  /CONFIG  parameter  is  used  in  conjunction with "dynamic"
  1435.         configuration  parameters  to  enable  or  disable  them.   For a
  1436.         complete  description  of  this  feature,  please see the section
  1437.         called "Dynamic Parameters".  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1452.  
  1453.  
  1454.         Feb 24, 1996          KSP Telnet (tm) v5.0                     23
  1455.  
  1456.  
  1457.                    CHAPTER 5 - INSTALLING YOUR ACCESS KEY     
  1458.  
  1459.  
  1460.         The  unlicensed  version  of  KSP  Telnet  limits  each user to a
  1461.         maximum  of  five minutes per session.  To remove this limit, you
  1462.         must  purchase  an  access key and install it as described below;
  1463.         once  installed,  users  will  be  limited  only  by  their  time
  1464.         remaining on the BBS.  
  1465.  
  1466.         There  are  three  parameters  that  must  be  specified  in  two
  1467.         environment  variables called "KSP-ID" and "KSP-TLNT" in order to
  1468.         install  your access key; the access key will not be validated if
  1469.         any parameter is missing.  
  1470.  
  1471.         The  environment  variable  "KSP-ID"  is used to specify your BBS
  1472.         name, as in: 
  1473.  
  1474.                       set KSP-ID=Key Software Products BBS
  1475.  
  1476.         The  name of your BBS is displayed each time KSP Telnet begins to
  1477.         run.  
  1478.  
  1479.         The  environment  variable  "KSP-TLNT"  is  used  to  specify the
  1480.         number  of BBS nodes and your access key separated by a semicolon
  1481.         as in: 
  1482.  
  1483.                              set KSP-TLNT=2;12345678
  1484.  
  1485.         The  access  key  is  derived  from  the name of your BBS and the
  1486.         number   of   BBS  nodes.   The  specified  key  must  match  the
  1487.         combination  of BBS name and nodes.  If not, or if you invoke KSP
  1488.         Telnet  on  a  node  whose node number is greater than indicated,
  1489.         then the caller will be limited to five minutes per session.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1510.  
  1511.  
  1512.         Feb 24, 1996          KSP Telnet (tm) v5.0                     24
  1513.  
  1514.  
  1515.                        CHAPTER 6 - USING KSP TELNET      
  1516.  
  1517.  
  1518.         KSP  Telnet  provides  three  different user interfaces.  Callers
  1519.         who  have  RIP  graphics  enabled  see  a RIP graphics interface.
  1520.         Others  who  have  ANSI  graphics  enabled  see  an ANSI graphics
  1521.         version  of  this interface provided they (1) are not in "expert"
  1522.         mode,  and  (2)  their DCE (carrier) speed is at least 9600 baud.
  1523.         Otherwise, a standard command line interface (CLI) is used.  
  1524.  
  1525.         The  CLI  interface  is  similar  to  that  found in conventional
  1526.         telnet  programs  available on most large computers.  The RIP and
  1527.         ANSI  graphics  interfaces provide the same functionality with an
  1528.         improved "look and feel".  
  1529.  
  1530.         Regardless  of  the  user interface, the user is always either in
  1531.         command   mode   or   else  connected  (talking)  to  the  remote
  1532.         computer.   The "open" command is used to go from command mode to
  1533.         connected  mode; the KSP Telnet "escape character" (not the "Esc"
  1534.         key)  is  used to "escape" back to command mode.  (Note: The user
  1535.         may  also get back to command mode by sending a "break signal" to
  1536.         the BBS.) 
  1537.  
  1538.  
  1539.         6.1 Command Mode Basics (CLI Only)     
  1540.  
  1541.         The  following  basic  editing  keys are available while entering
  1542.         commands in the command line user interface: 
  1543.  
  1544.         Question        Displays a list of keywords that match the
  1545.         Mark            partially entered command.
  1546.  
  1547.         BackSpace       Rubs out the previous character.
  1548.  
  1549.         Escape          Rubs out the previous word.
  1550.  
  1551.         Keywords  may  be  abbreviated;  KSP  Telnet  will complete their
  1552.         spelling automatically.  
  1553.  
  1554.  
  1555.         6.2 Connected Mode Basics (CLI Only)     
  1556.  
  1557.         While  connected  to  a  remote computer, the following keys have
  1558.         special meaning: 
  1559.  
  1560.         Default   Keyname         Description
  1561.         -------   -------         ------------------------------
  1562.         ^O        abort           Aborts current console output
  1563.         ^U        erase           Erases current input line
  1564.  
  1565.  
  1566.  
  1567.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1568.  
  1569.  
  1570.         Feb 24, 1996          KSP Telnet (tm) v5.0                     25
  1571.  
  1572.  
  1573.         ^]        escape          Escapes back to command mode
  1574.         ^T        hello           Causes host to print something
  1575.         ^Y        interrupt       Aborts current process
  1576.         ^H        rubout          Erases previous character
  1577.  
  1578.         The  particular  keystrokes  assigned  to  these functions can be
  1579.         reassigned  using  the  KSP  Telnet  "set"  command;  the current
  1580.         settings can be displayed using the "show" command.  
  1581.  
  1582.  
  1583.         6.3 KSP Telnet Commands (RIP ANSI and GUI)   
  1584.  
  1585.         Command(s)      Description
  1586.         ----------      --------------------------------------
  1587.         ascii           Enables ascii mode (instead of binary
  1588.                         mode - see below).
  1589.  
  1590.         binary          Enables binary mode.  Useful for file
  1591.                         transfers.  While enabled, the normal
  1592.                         escape character will not be recognized,
  1593.                         but the "Break" signal will.
  1594.  
  1595.         close           Closes the current connection (if any)
  1596.                         to a remote host.
  1597.  
  1598.         flow            Toggles xon/xoff flow control.
  1599.  
  1600.         goodbye,bye     Performs a close and then logs off the
  1601.                         BBS.
  1602.  
  1603.         help            Displays a brief explanation of available 
  1604.                         commands.
  1605.  
  1606.         open [host]     Establishes a connection to a remote
  1607.                         host. "host" may be followed by a port
  1608.                         number, separated by one of {,;:/}.
  1609.  
  1610.         options         Toggles display of Telnet option
  1611.                         negotiation at start of a connection.
  1612.  
  1613.         quit,exit       Performs a close and then returns to
  1614.                         the BBS.
  1615.  
  1616.         resume          Returns from command mode to the
  1617.                         currently connected host (if any).
  1618.  
  1619.         set <ctrlkey>   Changes the connected mode keystroke
  1620.                         assignments.
  1621.  
  1622.  
  1623.  
  1624.  
  1625.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1626.  
  1627.  
  1628.         Feb 24, 1996          KSP Telnet (tm) v5.0                     26
  1629.  
  1630.  
  1631.         show            Displays the current connected mode
  1632.                         keystroke assignments.
  1633.  
  1634.         term [type]     Change the terminal type transmitted to
  1635.                         the remote host by KSP Telnet at start
  1636.                         of a session.
  1637.  
  1638.         zmodem          Toggles automatic regonition of Z-Modem
  1639.                         transfers.  If enabled, KSP Telnet will
  1640.                         automatically switch to binary mode for
  1641.                         the duration of the transfer.
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1684.  
  1685.  
  1686.         Feb 24, 1996          KSP Telnet (tm) v5.0                     27
  1687.  
  1688.  
  1689.                         APPENDIX 1 - HOW TO REACH US     
  1690.  
  1691.  
  1692.         The  Key Software Products BBS/FAX number (415-364-9847) operates
  1693.         24   hours   a   day,  7  days  a  week.   Software  at  our  end
  1694.         automatically  determines whether an incoming call is data or FAX
  1695.         and will operate accordingly.  
  1696.  
  1697.         If  you have access to electronic mail, you can send us a message
  1698.         via any of the following: 
  1699.  
  1700.         On COMPUSERVE, send mail to:
  1701.  
  1702.                 >Internet:tech.support@ksp.com
  1703.  
  1704.         On PRODIGY, send mail to: VGDC59A
  1705.  
  1706.         On Internet, UUCP, or Bitnet, send mail to:
  1707.  
  1708.                 tech.support@ksp.com
  1709.  
  1710.         On Fidonet, address mail to "UUCP" at nearest fidonet site which
  1711.         provides a gateway to Internet, such as 1:105/42.
  1712.  
  1713.                 1st line of message: To: tech.support@ksp.com
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1742.  
  1743.  
  1744.         Feb 24, 1996          KSP Telnet (tm) v5.0                     28
  1745.  
  1746.  
  1747.                 APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    
  1748.  
  1749.  
  1750.         The  main  distribution  file  is KSPTEL??.ZIP, where "??" is the
  1751.         version  number.  You can retrieve this file via anonymous ftp at
  1752.         "scizzl.scu.edu",  directory "ksp".  Please note that there is no
  1753.         "e" at the end of "scizzl".  
  1754.  
  1755.         This  file  is also available from the KSP BBS, either by calling
  1756.         in   and   downloading,   or  via  e-mail  using  the  "LISTSERV"
  1757.         capabilities of the BBS.  
  1758.  
  1759.         To  use  LISTSERV,  you  must  send  a  message  addressed to the
  1760.         Internet  address  listserv@ksp.com.  The message must contain an
  1761.         LISTSERV  command  entered  as a single line of text, and it must
  1762.         be  the first line in the message. The LISTSERV commands that are
  1763.         supported include: 
  1764.  
  1765.         Command: HELP tlbmm-l
  1766.         Purpose: Returns an text file with help information about LISTSERV.
  1767.  
  1768.         Command: DIR tlbmm-l
  1769.         Purpose: Returns an e-mail message listing all of the file 
  1770.                  directories on the BBS by number and description.
  1771.  
  1772.         Command: LIST tlbmm-l 1
  1773.         Purpose: Returns an e-mail message listing all of the files in
  1774.                  directory #1 of the BBS.
  1775.  
  1776.         Command: GET tlbmm-l KSPTEL50.ZIP
  1777.         Purpose: Returns an e-mail message containing a uuencoded version of
  1778.                  the file KSPTEL50.ZIP.  To extract the file, you must save
  1779.                  the message as a file on your system, edit out the e-mail
  1780.                  header at the beginning of the file, and then use a program
  1781.                  called UUDECODE (commonly available on Unix) to convert the
  1782.                  uuencoded version back to the original ZIP format, and then
  1783.                  (finally) use PKUNZIP to extract the contents of the file.
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1800.  
  1801.  
  1802.         Feb 24, 1996          KSP Telnet (tm) v5.0                     29
  1803.  
  1804.  
  1805.                          APPENDIX 3 - LEGAL STUFF       
  1806.  
  1807.  
  1808.                                 LIMITED WARRANTY
  1809.  
  1810.         This  software  is provided 'as is' without warranty of any kind,
  1811.         either  expressed  or  implied, including, but not limited to the
  1812.         implied   warranties   of   merchantability  and  fitness  for  a
  1813.         particular  purpose.   The  entire  risk  as  to  the quality and
  1814.         performance of the program is with you.  
  1815.  
  1816.         Some  states do not allow the exclusion of implied warranties, so
  1817.         the  above  exclusions may not apply to you.  This warranty gives
  1818.         you  specific  legal  rights  and  you may also have other rights
  1819.         which vary from state to state.  
  1820.  
  1821.         Key  Software  Products  has  taken  due  care  in  preparing the
  1822.         documentation  and  software  included  in   to  ascertain  their
  1823.         correctness  and  effectiveness.   However, Key Software Products
  1824.         does  not  warrant  that  operation  of  this  software  will  be
  1825.         uninterrupted  or  error  free.   In  no event shall Key Software
  1826.         Products  be  liable  for  incidental or consequential damages in
  1827.         connection  with  or  arising out of the furnishing, performance,
  1828.         or use of this software.  
  1829.  
  1830.  
  1831.                                      LICENSE
  1832.  
  1833.         You  MAY  use  this software on any computer or computers in your
  1834.         possession.   The licensed version is registered for use on up to
  1835.         a  fixed  number of BBS nodes running on multiple machines and/or
  1836.         multiple multi-tasking processes.  
  1837.  
  1838.         You  MAY  copy this software into any machine readable or printed
  1839.         form  for  backup or modification purposes in support of your use
  1840.         of the software.  
  1841.  
  1842.         You  MAY  distribute  the original unmodified, unlicensed version
  1843.         of  this  software,  but you may not charge a fee exceeding $5.00
  1844.         to  cover  the  cost of duplicating, shipping, and handling.  You
  1845.         may NOT distribute a licensed version of this software.  
  1846.  
  1847.         You  may  NOT  use,  copy, modify, sublicense, assign or transfer
  1848.         this  software  and  its license, or any copy or modification, in
  1849.         whole  or  in  part,  except  as  expressly  provided for in this
  1850.         license.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1858.  
  1859.